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Chapter 1 


INTRODUCTION 


Cromemco INFORMIX for UNIX System V is a general-purpose database 
management system for all your data storage and retrieval needs. 
Because 
INFORMIX is a true relational database system, it is extremely flexible, and 
therefore ideal for a multi-user environment. 


An INFORMIX database consists of a series of files, each containing a series 
of data records. If a record in one database file can be related to a record in 
another database file, INFORMIX can join the records--without phy sically 
linking the files. It is this capability--to join parts of the database based on 
their relation to one another--that makes INFORMIX a true relational database 
management system. 


A relational system such as INFORMIX is interactive and dynamic. 
With the 
INFORMIX interactive query languages, users can extract information from 
several database files. Such cross-file queries are difficult or impossible with 
non-relational database systems. 


As databases evolve, so do the inter-relationships among the database files. 
INFORMIX lets you take advantage of these relationships at any time. 
(You 
don't need to define the relationship when setting up the database.) 


INFORMIX, Model INFX-XS, is supplied with the following programs (summarized 
in the next chapter and discussed in detail in the INFORMIX manuals): 


DBBUILD 
DBSTATUS 
ENTER1 
ENTER2 
INFORMER 
ACE 
PERFORM 
DBMENU 


database compiler 
database monitor 
data entry program for hardcow terminals 
data entry program for CRT terminals 
query language program 
relational report writer 
screen data entry system 
menu builder 


C-Language Application Library Routines 


App'endix A contains information for individuals wishing to write C language 
programs for use with INFO~MIX. 
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DATABASES SUPPLIED WITH INFORMIX 


Four databases are included with the INFORMIX software. 
Three of the 
databases (stores, realty, and bank) are samw.e databases. 
With copies of 
these databases (and associated files) in your working directory, you can 
duplicate the examples in the INFORMIX manuals. 


The fourth database (menu) is not a sample. Using this database (and associated 
files), you can create menus using the DBMENU program. 
(DBMENU is 
summarized in the next chapter.) 
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Chapter 2 


PROGRAM SUMMARY 


DBBUILD 


DBBUIW is the database compiler. 
Before you use DBBUIW, you must create 
a file that describes the database. DBBUI LD uses this file--called a schema--to 
create the necessary database files. 
The schema specifies the fields for each 
record of a database file--each file in the database has an associated schema 
file. 


If you wish to change the structure of a database, edit the schema file. 
From 
the revised schema, DBBUIW (with the -r option) will recompile the database 
to the new specification. 


ENTER1 and ENTER2 


ENTERl and ENTER2 let you enter data in database files. 
ENTERl is for use 
with hardcop./ terminals, while ENTER2 is for use with CRT terminals. 
Using 
these programs, you can add, delete, or update records. 


The following figure shows a typical ENTER2 screen. 


Commands: Find. Next Previous Update Add Delete Select Redraw Bye 1. 


emp_no 
last_name 
first_name 
dept_no 
date_hire 


Figure 2-1: ENTER2 SCREEN 
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INFORMER 


INFORMER lets you query--ask for specific information about--the data in a 
database. For example, assume your database contains personnel records. Using 
the INFORMER query language, you can ask for a list of all employees in a 
specific department or of all employees who were hired in the last six months. 
If the information you need is contained in several database files, INFORMER 
can join the related fields. 


The language, or syntax, of INFORMER queries is simple to learn and easy to 
use. 


DBSTATUS 


DffiTATUS--the database monitor--helps the database administrator (or other 
sophisticated user) maintain the database. 
Using DBSTATUS commands, the 
database administrator can add or delete indexes; print the status of selected 
database files; or even delete an entire database. 


DffiTATUS can also be used to set up audit trails for database files. 
After 
establishing an audit trail with the START AUDIT command, modifications to 
a database file are recorded in an audit-trail file. 
Audit trails enable the 
database administrator to reconstruct the database following a hardware or 
software failure. 


DffiTATUS can be used to load an entire database from an operating system file 
(the. data must be in machine-readable form). 
DBSTA'IUS can also be used to 
unload a database to an operating sy stem file. 
In th is way, DffiTA'IUS lets the 
Database Administrator transport a database to another system (t¥ transferring 
the operating system file to tape). 


ACE 


The ACE program lets you use INFORMIX to produce reports. 
Because ACE is 
a relational report writer, it can take information from several database 
files--joining those files based on the relationship you define. 


Unlike special-purpose report writers (for example, a program that produces 
only mailing labels), the ACE report writer handles a wide range of 
database-oriented applications. 
For example, suppose you set up a database 
for inventory control. Using ACE, you can produce the day-to-day reports you 
need to monitor stock--plus the more formal reports you need for long-range 
planning. 
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PERFORM 


PERFORM creates customized screens for data entry and analy sis. 
Your 
form-specification file determines what the PERFORM screen looks like. 
(To 
create a form-specification file, use the Cromemco Screen program-entry editor 
or another text editor.) 
After compiling the form-specification file with 
Formbuild, you are ready to select PERFORM from the I NFORMIX menu. 


The following figure shows a typical PERFORM screen: 


Query Next Previous Add Update Remove File Screen Current Master Detail 
Output Bye 
•• 1: listings 
f~_*· 


Real Estate Listings for Single Family Dwellings 
in Santa Clara CountYt California 


agent 
name 
( 


listing number 
(0 
1 


foota ge 
[0 
) 


street address 


bedrooms 
baths' 
lotsize 
[0 
) 
[0 
) 
(0.0 


c1 ty 


corner 
schools 
( 1 
[ ) 


asking price 
[$0.00 


listing note [ 


sal e pri ce 
($0.00 


Figure 2-2: PERFORM SCREEN 


Like ENTER2, PERFORM lets you add, delete, or update database records. But, 
with PERFORM, you control the screen layout. 
You can place fields in any 
location, with the labels or titles you choose. 
Usir~ relational "joins," you can 
design a screen containing selected fields from several files. 


PERFORM's Query command lets you enter queries on the PERFORM screen. 
In 
this way, you can "browse" through a database, selecting records or groups of 
records based on your queries. 


DBMENU 


DBMENU, in combination with PERFORM, lets you create customized menus for 
almost any application. 
From the menus you design, you can select submenus 
or programs (application programs or your own shell scripts). 
Menus make your 
software readily accessible and easy to use. 


The menu database, as supplied with the INFORMIX software, is ready to use. 
After designing a menu structure (refer to the INFORMIX documentation), use 
PERFORM to create the neCessary menus. 
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'.. 
Figure 2-3 shows a PERFORM screen with the Menu Entry Form displayed. 


============================= MENU ENTRY FORM ============================= 


Enter menu name, title, and spacing for all menus first. 
Then complete Selection Section for each selection of each menu. 


Menu name: 
[ 
Menu title: 
[ 
Line spacing: 
[OJ 
J 


--------------------- 
SELECTION SECTION ---------------------------- 
Selection number: 
0 
Selection type: 


Selection 
text: 


Program to 
execute: 


Next menu name: 
=========================================================================== 


Figure 2-3: PERFORM SCREEN WITH MENU ENTRY FORM 
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Cbapter 3 


I NSTALLATION 


This chapter explains how to install the INFORMIX software on a Cromemco 
UNIX system. 
A basic knowledge of UNIX System V is assumed. 


BEFORE YOU BEGIN 


1. 
Check available space on the hard disk. 
You will need approximately 
1,600K 
~tes of available space. 


2. 
Make sure you know the serial number of your software and your serial 
number KEY. (This information is written on a label that is affixed to each 
INFORMIX diskette.) The serial number is a seven-digit number preceded 
~ "CRO-R"_-the serial number KEY is a sequence of six alphanumeric 
characters. 


INSTALLATION PROCEDURE 


1. 
Log in as a super user, and insert the diskette containing the software in 
a floPW disk drive. 


2. 
Make a directory on the hard disk to serve as temporary storage. 


For example: 


1 -) mkdir lusr/informix 


For illustration purposes, lusr/informix is assumed to be the name of the new 
directory throughout this manual. 


3. 
Make the new directory the current directory: 


2 -) cd lusr/informix 
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..... 
4. 
Using the Tar utility, copy the contents of the diskette to the current 
directory. 


For example: 


3 -> tar -xvi /dey/fda 


or 


3 -> tar -xyf /deY/sfda 


(System 300) 


(System 100) 


Cow the contents of Disk 1, then Disk 2, and so on, until all files are 
copied to the current directory. 


5. 
Run the Installit shell script: 


4 -> installit 


a. 
Press RE'IURN when Installit displays the following message: 


This installation procedure must be run ~ root (super user) 
Press RE'IURN to continue, DELETE to abort: 


b. 
When Installit prompts: 


Enter serial number > 


type your serial number (using UPPERCASE letters where applicable) 
and press RETURN. 


For example: 


Enter serial number > CRO-R1234567 


c. 
When Installit prompts: 


Enter serial number KEY > 


type your serial number KEY and press RETURN. 
Once again, use 
UPPERCASE letters where applicable. 


For example: 


Enter serial number .KEY > W55JWF 


.. . .~~..., 
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6. 
Installit now moves the INFORMIX program files to /usr/bin and the 
C-language library files to /usr/lib and /usr/include. 


As the files are moved, Installit displays the following messages: 


Moving binaries ••• 
Moving libraries ••• 


During the transfer, Installit "brands" each program with the serial number 
of the INFORMIX software. The INFORMIX software is now installed and 
ready to use. 


IMPORTANT: 
"Branding" (step 6) takes place only if you entered a valid serial 
number and serial number KEY. Installit displays an error message if it cannot 
"brand" the programs. 


If Installit could not "brand" the programs, either: 


1. 
Repeat the installation from step 4 (copying the software to 
/usr/informix); or 


2. 
Move the appropriate files back to /usr/informix, and repeat the 
installation procedure from step 5 (moving and "branding" the software). 


INFORMIX FILES 


For reference, this sections lists the INFORMIX files now contained in /usr/bin, 
/usr/include, /usr/lib, and /usr/informix. 


Installit moved these files to /usr/bin: 


acego 
aceprep 
bcheck 
dbbuild 
dbmenu 
dbstatus 
disable 
enter1 
enter2 
formbuild 
informer 
informix 
perform 
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Installit moved these files to lusr/include: 


ace.h 
dbiooh 
rdstermoh 


Installit moved these files to lusr/lib: 


libace.a 
libdb.a 


Installit left these files in lusr/iDformix: 


(sample database bank) 


bank.dbd 
bankCllst.dat 
bankcllst.idx 
bankcllstJok 
bankrepl 
bankrep2 
bCllstsch 
department.dat 
department.idx 
departmentJok 
deptsch 
emp2sch 
employeeodat 
employee.idx 
employeeJok 
loan.dat 
loan.idx 
loanJok 
loansch 


(sample database realty) 


agents.dat 
agents.idx 
agentsJok 
agentsch 
listgsch 
listings.dat 
listings.dat 
listings.idx 
listingsJok 
listrep 
real1 
real2 
real3 
real4 
realty.dbd 
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(sample database stores) 


allexample.c 
customers.dat 
customers.idx 
customersJok 
custsch 
orderrep 
orders.dat 
orders.idx 
ordersJok 
ordersch 
rep! 
rep2 
rep3 
rep4 
repS 
rep6 
rep7 
rep8 
rep9 
rep!O 
stores.dbd 


(database menu for DBMENU program) 


menuform 
menuform.frm 
menuitem.dat 
menuitem.idx 
menuitemJok 
menus.dat 
menus.idx 
menusJok 
menus.sch 
mitems.sch 
mmprog.c 
mmterm.c 
mmutil.c 


(mise. files) 


brand 
installit 
linkex 
termcap 


source code for DBMENU program 


compiles and links allexample.e (the sample C program) 
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Chapter 4 


GETTING STARTED 


This chapter provides a short tutorial on the use of the program. This tutorial 
is not intended to be an in-depth use of the program. 
Its purpose is to 
familiarize you with some basic concepts, such as selecting the INFORMIX 
program, using the INFORMIX menu, and exiting from the program. 


CREATING A SCHEMA 


To see how DBBUILD creates the operating system files for a database, you may 
wish to create a simple schema file--and compile it with DBBUILD. If so, use 
the VI text editor (or another UNIX editor) to create a new file named schema. 


Then enter the following text and save the file. 


database personnel 


file employees 


( 
field 
field 
field 
field 
field 


end 


emp_no 
last.Jlame 
first.Jlame 
dept_no 
dateJtire 


type serial 
type character 
ty pe character 
type integer 
type date 


length 15 
length 15 


Like every schema file, this file begins with the name of the database 
(personnel), followed by the name of a file (employees). 
DBBUILD uses this 
information to create the necessary operating system files. 


The remaining information in the schema describes the fields in one record of 
the employees file--the first file of the database personnel. (Field identifiers 
and data types are discussed in detail in the DBBUI LD manual.) 
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COMPILING THE DATABASE WITH DBBIDLD 


To compile the personnel database, enter the following command. 


2 -> dbbuild schema 


When compilation is complete,your terminal will look like Figure 4-1. 


DBBUILD Data Description Language Compiler 
INFOR~nX version 
X.XX 
Copyright ee) 
1981, 1982, 1983 Relational Database Systems, 
Inc. 
Software Serial 
Number 
RDS-XXXXXX 


The file 
"schema" will 
now 
be compiled. 


The compilation was successful. 
The file that holds the dictionary 
for the database "personnel II has been created or updated. 


Program over. 


Figure 4-1: SCREEN DISPLAY FOLLOWING DBBUILD 


FILES CREATED BY DBBUILD 


Listing the files in the current directory will display the names of four new 
files. Similar files are created whenever you use DBBUI LD to compile the first 
file of a database. 


3 -> Is -1 


-rw-rw-r-- 
1 
name 
users 
0 
8ep 21 18:58 
emp'l~ees.dat 
-rw-rw-r-- 
1 
name 
users 
xxxx 
Sep 21 18:58 
employees.idx 
-rw-rw-r-- 
1 
name 
users 
xxx 
Sep 21 18:58 
empl~eesJok 


-rw-rw-r-- 
1 
name 
users 
xxx 
Sep 21 18:58 
personnel.dbd 
-rw-rw-r-- 
1 
name 
users 
xxx 
Sep 21 18 :53 
schema 


The file personnel.dbd is the dictionary file for the new database. 
(If you 
compile a second file for the personnel database, this file is automatically 
updated.) 
The remaining files are the employees database file. 


The Jdx file contains file-indexing information; the .lok file contains 
record-locking information; and the .dat file will contain the actual data for 
the file. 
Similar files are created whenever you use DBBUI LD to compile a 
database. 
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ENTERING DATA WITH ENTER2 


With the database personnel compiled, select the INFORIvlIX program 
I::N 


entering the following command: 


4 -> informix 


The program has been selected when the INFORIvlIX menu appears on your 
screen. 


INFORMIX Master Menu 
INFORHIX version 3.11 
Copyright (C) 1981, 1982, 
1983 Relational Database Systems, 
Inc. 
Software Serial Number 
RDS-XXXXXX 


t.'.:..... "':" ... 


1. 
Perform 
2.. 
Acego 
3.. 
Informer 
4. 
Select 
5. 
Dbstatus 
6. 
Schema 
7. 
Enter2 
8. 
Enter1 
9. 
System 


Data entry and query 
by 
forms 
Run 
Ace report 
Query language 
Database selection 
Database administration 
Pri nt data base schema 
SC'reen-oriented data entry 
Data entry 
Operating system command 


\. 


( 


Use space bar, arrow keys, 
or type 
IF to make selection. 
Enter 'b' to exit. 
Enter carriage return to execute selection: 1. 


Figure 4-2: INFORMIX MENU 


With the INFORMIX menu displayed, select the ENTER2 program. 
(Press the 
SPACE bar or the ARROW keys to select Item 7 from the menu, then press 
RETURN.) 


Before you use ENTER2, you will need to specify a database name (personnel) 
and a filename (employees). Figure 4-3 shows ENTER2 prompting for the name 
of the database. 
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," 
'.' 


The following databases are available: 


1. 
personnel 


Use space bar, 
arrow keys, 
or type 
f.I to make selection. 
Enter 'b ' 
to exit. 
Enter carriage return to execute selection: 1. 


Figure 4-3: DATABASE NAME PROMPT 


Because there is only one database to choose from, the personnel database is 
already selected. 
Press the RE'IURN key to enter the selection. 


ENTER2 now prorr..pts for a filename. 
Once again, you can answer this prompt 
by pressing the RE'IURN key. 
(There is only one file to choose from.) 


You are ready to enter data in the employees file when your screen looks like 
Figure 4-4. 


Commands: Find Next Previous Update Add Delete Select Redraw Bye 1. 


emp_no 
last_name 
first_name 
dept_no 
date_hire 


Figure 4-4: ENTER2 SCREEN 


" 
..·.t·· 
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At the top of the screen is the ENTER2 command line. Typing the first letter 
of a command (for example, A for AWl) enters that command. 


Note: 
As with most INFORMIX programs, you exit from ENTER2 by typing B 
for ~ 
When you exit ENTER2, the INFORMIX menu is redisplayed. 
Typing B from the INFORMIX menu exits you from the I NFORMIX 
program completely. 


For the first record in the employees file, you may wish to use the following 
data: 


Jones 
Mary 
806 
7/10/82 


To create the record, ty pe A for AWl. As shown in Figure 4-5, the cursor moves 
to the first field where you must enter data. 
(The cursor skips the "emp_no" 
field because defining "emp_no" as serial causes ENTER2 to number this field 
automatically when you complete the record.) 


Commands: 
Find Next 
Previous Update Add Delete Select 
Redraw Bye? 


( 


emp_no 
last_name 
first_name 
dept_no 
date_hire 


[0 
[8 
( 
[0 
J 
[00/00/00 J 


Current search field is lJemp_no" 


Figure 4-5: ENTER2 SCREEN WITH BLANK RECORD 
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Now complete each field by typing the appropriate data and pressing the 
RETURN key. 
(Pressing RETURN automatically moves the cursor to the next 
field.) 
As you enter data in each field, ENTER2 checks the dictionary file 
personnel.dbd to make sure you typed valid data for that field. 


Correcting Mistakes and Abortiug Commands 


If you notice a mistake, use the ARROW keys to move the cursor to 
the error and ty pe over it. 
(The UP or DOWN ARROW key s move the 
cursor up or down, by fields.) 


To abort the Add command, or any other ENTER2 command, press 
DELETE. 


When you have completed the last field, "dateJ'liredll , ENTER2 asks if the record 
is complete (Figure 4-6). 
(With the cursor in any data field, pressing the 
ESCAPE key displays this prompt so you can add or update a record; pressing 
ESCAPE a second time returns the cursor to the data field.) 


Commands: 
Find 
Next Previous Update Add Delete Select Redraw Bye? 


"." 


emp_no 
last_name 
first_name 
dept_no 
date_hire 


Record complete? 


[1 
[ Best 
[Joyce 
[806 
1 
[01110/82] 


Figure 4-6: ENTER2 SCREEN WITH COMPLETED RECORD 


Answer "yesll by typing Y. 
The record is added. 


Enter the Add command again (ENTER2 will automatically display the next blank 
record). 
Now add a second record with the following information. 


Smith 
Barbara 
702 
5/5/80 
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,: 


When you have entered data in the last field, answer the Record Corog1ete? 
prompt t:!f typing Y. 


The employees file now contains two data records. Unless you wish to add other 
records, or to experiment with some of the commands discussed in the ENTER2 
manual, quit ENTER2 by ty ping B for bo 


When the INFORMIX menu is redisplayed, type B for .,B,yjt a second time. Typing 
B from the INFORMIX menu displays the message: 


Program oyer. 


and returns control to the operating system. 


By listing the files in the current directory, you can see that the file 
employees.dat now contains data--the two records you just entered. 


5 -> Is -1 


-rw-rw-r-- 
1 
name 
users 
xxx 
Sep 21 18:58 
employeesodat 
-rw-rw-r-- 
1 
name 
users 
xxxx 
Sep 21 18:58 
employees.idx 
-rw-rw-r-- 
1 
name 
users 
xxx 
Sep 21 18 :58 
employeesJ.ok 
-rw-rw-r-- 
1 
name 
users 
xxx 
Sep 21 18:58 
personnel.dbd 
-rw-rw-r-- 
1 
name 
users 
xxx 
Sep 21 18 :53 
schema 


The INFORMIX manuals contain detailed operating instructions for each program. 
To duplicate the examples in the manuals, you will need copies of the sample 
database files (chapter 3) in your working directory. 


SELECTING PROGRAMS IN RESPONSE TO THE OPERATING SYSTEM PROMPT 


Using the INFORMIX menu is an easy way to select programs. 
However, you 
can also select INFORMIX programs by typing commands in response to the 
operating system prompt. 
For example, the following command selects the 
ENTER2 program. 


6 -> enter2 


This command selects ENTER2 and the personnel database (you do not have 
to specify a database after giving the command). 


7.-> enter2 personnel 
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Appendix A 


USING THE C LANGUAGE APPLICATION LIBRARIES 


With the INFORMIX C Application Language Library (ALL-II) routines, 
programmers can write C programs to manipulate the database. 
For example, 
some routines add or delete data (performing the same function as ENTER1 or 
ENTER2). 
Others query the database (performing the same function as 
INFORMER). 


The sample C program, allexample.e (supplied with the INFORMIX software), 
demonstrates the available routines. 


Including the Define Statements in a C Program 


Installing the INFORMIX software moves the file dbio.h to the directory 
/usr/include. This file contains C define statements for the application library 
routines. 
INFORMIX requires this information to compile a C program, and the 
first statement in your program must include the file. 
For example: 


If include <dbio.h> 


If dbio.h is not in Iusr/ipclude, the compiler will abort.. 


Note: 
The include statement at the beginning of allexample.c (the sample 
C program) assumes dbio.h is present in the current directory. 
Before 
running this program, edit the statement and enclose the filename in 
angle brackets. 


Compiling and Linking C Programs 


If your C program uses the ALL-II routines, you can compile and link the 
program by giving the following command: 


1 -> cc progname.o -ldb -0 outputname 


where: progname.o is the name of your program and outputname is the output 
file. 
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The Linkex shell script in lusr/informix compiles and links the sample C 
program allexample.c. 


3 -) lusr/informix/linkex 


To compile and link an ACE program that calls your own routines, give the 
following command: 


2 -) cc userfunc.o mycode.o -lace -ldb -0 myace 


where: mycode.o is the object file that contains the routines and myace is 
the executable output. 
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